package com.zjcloud.jwgl.service;

import java.util.List;
import com.zjcloud.jwgl.domain.ScCourse;

/**
 * 课程信息Service接口
 * 
 * @author zjcloud
 * @date 2024-12-19
 */
public interface IScCourseService 
{
    /**
     * 查询课程信息
     * 
     * @param id 课程信息主键
     * @return 课程信息
     */
    public ScCourse selectScCourseById(Long id);

    /**
     * 查询课程信息列表
     * 
     * @param scCourse 课程信息
     * @return 课程信息集合
     */
    public List<ScCourse> selectScCourseList(ScCourse scCourse);

    /**
     * 新增课程信息
     * 
     * @param scCourse 课程信息
     * @return 结果
     */
    public int insertScCourse(ScCourse scCourse);

    /**
     * 修改课程信息
     * 
     * @param scCourse 课程信息
     * @return 结果
     */
    public int updateScCourse(ScCourse scCourse);

    /**
     * 批量删除课程信息
     * 
     * @param ids 需要删除的课程信息主键集合
     * @return 结果
     */
    public int deleteScCourseByIds(Long[] ids);

    /**
     * 删除课程信息信息
     * 
     * @param id 课程信息主键
     * @return 结果
     */
    public int deleteScCourseById(Long id);

    /**
     * 根据课程编码查询课程信息
     * 
     * @param courseCode 课程编码
     * @return 课程信息
     */
    public ScCourse selectScCourseByCode(String courseCode);

    /**
     * 检查课程编码是否唯一
     * 
     * @param scCourse 课程信息
     * @return 结果
     */
    public String checkCourseCodeUnique(ScCourse scCourse);

    /**
     * 根据学期ID查询课程列表
     * 
     * @param semesterId 学期ID
     * @return 课程列表
     */
    public List<ScCourse> selectScCourseBySemesterId(Long semesterId);

    /**
     * 根据学科ID查询课程列表
     * 
     * @param subjectId 学科ID
     * @return 课程列表
     */
    public List<ScCourse> selectScCourseBySubjectId(Long subjectId);

    /**
     * 根据年级ID查询课程列表
     * 
     * @param gradeId 年级ID
     * @return 课程列表
     */
    public List<ScCourse> selectScCourseByGradeId(Long gradeId);

    /**
     * 根据班级ID查询课程列表
     * 
     * @param classId 班级ID
     * @return 课程列表
     */
    public List<ScCourse> selectScCourseByClassId(Long classId);

    /**
     * 根据教师ID查询课程列表
     * 
     * @param teacherId 教师ID
     * @return 课程列表
     */
    public List<ScCourse> selectScCourseByTeacherId(Long teacherId);

    /**
     * 获取待排课程列表
     * 
     * @param semesterId 学期ID
     * @return 课程列表
     */
    public List<ScCourse> selectPendingCourses(Long semesterId);

    /**
     * 获取已排课程列表
     * 
     * @param semesterId 学期ID
     * @return 课程列表
     */
    public List<ScCourse> selectScheduledCourses(Long semesterId);

    /**
     * 获取需要连排的课程列表
     * 
     * @param semesterId 学期ID
     * @return 课程列表
     */
    public List<ScCourse> selectContinuousCourses(Long semesterId);

    /**
     * 更新课程排课状态
     * 
     * @param courseId 课程ID
     * @param scheduleStatus 排课状态
     * @return 结果
     */
    public int updateCourseScheduleStatus(Long courseId, String scheduleStatus);

    /**
     * 更新课程已排课时
     * 
     * @param courseId 课程ID
     * @param scheduledPeriods 已排课时
     * @return 结果
     */
    public int updateCourseScheduledPeriods(Long courseId, Integer scheduledPeriods);

    /**
     * 获取课程统计信息
     * 
     * @param courseId 课程ID
     * @return 统计信息
     */
    public ScCourse getCourseStatistics(Long courseId);

    /**
     * 批量导入课程
     * 
     * @param courseList 课程列表
     * @param isUpdateSupport 是否支持更新
     * @param operName 操作人
     * @return 结果
     */
    public String importCourse(List<ScCourse> courseList, Boolean isUpdateSupport, String operName);
}